home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 2: Applications / Linux Cubed Series 2 - Applications.iso / demos / multibas.rea < prev    next >
Text File  |  1996-11-16  |  15KB  |  573 lines
  1.                 
  2.  
  3. ============================================================================
  4.  
  5.  
  6.                            Installationsanleitung 
  7.  
  8.                      MultiBase/LINUX/UNIX - Testversion
  9.  
  10.                                 Version  2.0
  11.                 
  12.                                  Release 05
  13.  
  14. ============================================================================
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35. ST&C Software Tools & Consulting GmbH, Burgdorf/Hannover
  36. Telefon 05136-5799, Telefax 05136-5795
  37.  
  38. GS&H Gesellschaft für Soft- und Hardwarelösungen bR, Bad Oeynhausen
  39. Telefon 05731-28741, Telefax 05751-44958
  40.  
  41. TransTOOLs, S.A., Madrid
  42. Telefon +34-1-3026138, Telefax +34-1-7668710
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65. ----------------------------------------------------------------------------
  66. MultiBase/LINUX/UNIX                                              Januar 1995
  67.  
  68.  
  69. I. MultiBase/LINUX/UNIX auf dem Server
  70. --------------------------------------
  71.  
  72. MultiBase liegt auf den verschiedenen Servern als Datei MultiBase.tar vor.
  73.  
  74. Nach dem Dearchivieren dieser Datei erhält man im betreffenden Verzeichnis
  75. die z.T. gepackten Installationsdateien:
  76.  
  77. total 4048
  78. -rw-rw-rw-   1 root     other        7689 Jan 28 11:21 INST_ENG.TXT
  79. -rw-rw-rw-   1 root     other        7014 Jan 28 11:23 INST_GER.TXT
  80. -rw-rw-rw-   1 root     other     1357147 Jan 26 23:41 MB2005.tgz
  81. -rw-rw-rw-   1 root     other       98528 Jan 26 23:41 MBDemo.tgz
  82. -rw-rw-rw-   1 root     other       19745 Jan 27 00:06 MBFiles
  83. -rwxrwxrwx   1 root     other         654 Jan 27 14:14 MBInst
  84. -rw-rw-rw-   1 root     other      295107 Jan 26 23:41 MBLinux.tgz
  85. -rw-rw-rw-   1 root     other         465 Jan 27 00:01 MBMess
  86. -rw-rw-rw-   1 root     other     1154011 Jan 26 23:41 MBqref.tgz
  87. -rw-rw-rw-   1 root     other      724924 Jan 26 23:41 MBrefm.tgz
  88. -rw-rw-rw-   1 root     other      429466 Jan 26 23:42 MBuserm.tgz
  89. -rw-rw-rw-   1 root     other        9817 Jan 28 01:52 README.ENG
  90. -rw-rw-rw-   1 root     other        8309 Jan 28 11:16 README.GER
  91.  
  92.  
  93. Erläuterung der Dateiinhalte:
  94.  
  95. MB2005.tgz : 4GL, Datenbankserver, Lower Case Tools etc.
  96. MBDemo.tgz : Demoanwendung (Lager)
  97. MBLinux.tgz: Linux Konfigurationsdateien
  98. MBqref.tgz : Quick Reference Guide (Postscript Format)
  99. MBrefm.tgz : Reference Manual (Postscript Format)
  100. MBuserm.tgz: User's Manual (Postscript Format)
  101. MBInst,
  102. MBMess,
  103. MBFiles    : Installationsdateien
  104. README.ENG,
  105. README.GER : Über MultiBase
  106.  
  107.  
  108. II.  INSTALLATION VON MULTIBASE
  109. -------------------------------
  110.  
  111. II.1 Besonderheiten für die Linux Installation
  112. ----------------------------------------------
  113.  
  114. Für den Betrieb von MultiBase/Linux ist der Linuxkernel ab Version 1.0.9 
  115. und der iBCS Emulator für die entsprechende Version erforderlich. Ab der 
  116. Kernelversion 1.1.x sind für die Übersetzung des beiliegenden iBCS Quell-
  117. codes keine Patches erforderlich. Die Quellen befinden sich nach der 
  118. Installation im relativen Pfad <ctl/mblinux/iBCS>. Für die Übersetzung des
  119. Moduls muß der Linuxkernel konfiguriert auf der Zielmaschine vorliegen.
  120. Das iBCS Modul wurde bis einschließlich der Linuxversion 1.1.52 getestet.
  121. Zudem ist ein Tastatur- und Screenmapping notwendig. Alle erforderlichen 
  122. Konfigurationsdateien und -programme sind unter dem relativen Pfad
  123. <ctl/mblinux> vorhanden. 
  124.  
  125. ! Das compilierte iBCS Modul wird von dem Shellscript <mblinuxstart> im 
  126. ! Verzeichnis </usr/ctl/mblinux> erwartet.
  127. ! Sollte ein anderes Installationsverzeichnis gewählt werden, ist die
  128. ! Pfadangabe im Shellscript entsprechend zu ändern.
  129.  
  130. Nach erfolgreicher Installation muß das System für den MultiBase/Linux 
  131. Betrieb mit dem Befehl 
  132.  
  133.               /.../ctl/mblinux/mblinuxstart
  134.  
  135. konfiguriert werden. 
  136. Die hierfür erforderlichen Programme und Einstelltabellen befinden sich im 
  137. Konfigurationsverzeichnis 
  138.  
  139.                         /.../ctl/mblinux. 
  140.  
  141. In der Regel wird "..." "usr" sein. Es kann jedoch ein beliebiges Verzeichnis 
  142. gewählt werden. Hierbei ist auf die Einstellung der entsprechenden Umgebungs-
  143. variablen zu achten!
  144.  
  145. Soll das System bereits beim Start auf MultiBase/Linux Erfordernisse ange-
  146. paßt werden, muß die Befehlszeile 
  147.  
  148.                    /.../ctl/mblinux/mblinuxstart
  149.  
  150. in Abhängigkeit von der Linuxdistribution eingetragen werden in:
  151.  
  152.         /etc/rc.d/rc.local    (DLD Distribution)
  153. oder
  154.         /etc/brc        (unifix Distribution).
  155.  
  156. Im Konfigurationsverzeichnis 
  157.  
  158.                    /.../ctl/mblinux/mblinuxstart 
  159.  
  160. befindet sich außerdem die auf deutsche Sonderzeichen eingestellte "bash". 
  161.  
  162.  
  163. II.2 Installationsschritte
  164. --------------------------
  165.  
  166. ! Auf dem Zielrechner muß sich der GNU Komprimierer/Dekomprimierer <GZIP>
  167. ! befinden.
  168.  
  169. 1. Der user "ctl" mit der Gruppenzugehörigkeit "other" muß erstellt werden.
  170.  
  171. 2. Einloggen als user "ctl".
  172.  
  173. 3. Als "ctl" user in den Superuser Mode ($su) wechseln.
  174.  
  175. 4. Die oben aufgeführten Installationsdateien müssen sich im Verzeichnis
  176.    <ctl> befinden.
  177.  
  178. 5. Das Installationsscript <MBInst> aufrufen. 
  179.  
  180. 6. Für jeden Systembenutzer, der auf MultiBase/Linux zugreifen möchte, 
  181.    müssen in der Profile folgende Umgebungsvariablen gesetzt werden:
  182.  
  183.    PATH="$PATH:/.../ctl/bin"  (... absoluter Pfadanteil)    
  184.    TRANSDIR="/.../ctl"        (s. o.)
  185.    MBLANG="german"            (oder english oder spanish)
  186.    TERM=con80x25              (abh. vom Betriebssystem:
  187.                                   LINUX: con80x25
  188.                                   UNIX : AT386 ...)
  189.  
  190.    Weiter Umgebungsvariablen (DBMONEY,...) können dem Handbuch entnommen
  191.    werden.
  192.  
  193. 7. Zur Installation der Demoanwendung muß ein entsprechender user angelegt
  194.    werden. Ferner sind die Umgebungsvariablen (s.o.) zu setzen.
  195.    Anschließend muß man sich als entsprechender user einloggen. Nach Aus-
  196.    führung des Programms <installdemo> wird die Demoanwendung automatisch
  197.    installiert und gestartet. Sie enthält eine Anzahl an 4GL Quellpro-
  198.    grammen, die einen ersten Überblick über die Leistungsfähigkeit der
  199.    4GL (CTL) geben.
  200.  
  201. 8. Für Benutzer mit Linux Maschinen und HP Laserdruckern:
  202.  
  203.    Für einen funktionierenden Ausdruck auf HP-Laserdruckern ist 
  204.    folgende Umgebungsvariable zusätzlich zu setzen:
  205.    DBPRINT="/.../ctl/mblinux/lptrans"
  206.  
  207.  
  208. III. Beschränkungen der Testversion
  209. -----------------------------------
  210.  
  211. 1. Der CTL (4GL) Compiler verarbeitet maximal 1800 Statements (4GL-Statements)
  212.    pro Modul.
  213. 2. Die CTSQL beschränkt den Tabellenzugriff auf maximal 250 Zeilen pro
  214.    Tabelle.
  215.  
  216.       
  217. IV. Auswahl der Portierungsliste von MultiBase/UNIX & MultiBase/UNIX-MOTIF
  218. --------------------------------------------------------------------------
  219.  
  220. PC 80386, 80486
  221.  
  222. ALTOS
  223.     386 Series xx
  224.     486 Series xx
  225.     
  226. BULL
  227.     DPX 2000
  228.     DPX 2/ xxx
  229.  
  230. CONTROL DATA 
  231.     4340
  232.     4360
  233.     4380
  234.     4680
  235.  
  236. DATA GENERAL
  237.     AVIION xxxx
  238.         
  239. DEC
  240.     DECSTATION 2100, 3100, 5000/1xx, 5000, 5000-200
  241.     DECSYSTEM  3100, 5100, 5400, 5500, 58xx
  242.  
  243. FUJITSU
  244.     S-1400-1600
  245.     DS-90 xxx
  246.     M-730 Mod. xx
  247.     M-760 Mod. xx
  248.  
  249. HEWLETT-PACKARD
  250.     9000/3xx
  251.     9000/4xx
  252.     9000 SERIES 500
  253.     9000 SERIES 600
  254.     9000/8xx
  255.      
  256. IBM RS/6000 
  257.  
  258. SNI
  259.     RM-xx
  260.     MX-xx
  261.     Targon/31 ../32 ../35 
  262.     Targon 3300, 4400
  263.  
  264. UNISYS
  265.     5000/xxx
  266.     6000/xxx
  267.     7000/xxx
  268.                     
  269. ============================================================================
  270.  
  271.  
  272.                              Installation notes for 
  273.  
  274.                      MultiBase/LINUX/UNIX - evaluation copy
  275.  
  276.                                 Version  2.0
  277.                 
  278.                                  Release 05
  279.  
  280. ============================================================================
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301. ST&C Software Tools & Consulting GmbH, Burgdorf/Hannover (GERMANY)
  302. Phone +49-5136-5799, Fax +49-5136-5795
  303.  
  304. GS&H Gesellschaft für Soft- und Hardwarelösungen bR, Bad Oeynhausen (GERMANY)
  305. Phone +49-5731-28741, Fax +49-5751-44958
  306.  
  307. TransTOOLs, S.A., Madrid (SPAIN)
  308. Phone +34-1-3026138, Fax +34-1-7668710
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331. ----------------------------------------------------------------------------
  332. MultiBase/LINUX/UNIX                                             January 1995
  333.  
  334. ============================================================================
  335.  
  336.  
  337. I. Getting MultiBase/LINUX/UNIX from the Server
  338.  
  339. On the different servers the MultiBase package is stored in the file
  340. MultiBase.tar.
  341.  
  342. After running the TAR program, there are the following packed files in 
  343. the current directory: 
  344.  
  345. total 4048
  346. -rw-rw-rw-   1 root     other        7689 Jan 28 11:21 INST_ENG.TXT
  347. -rw-rw-rw-   1 root     other        7014 Jan 28 11:23 INST_GER.TXT
  348. -rw-rw-rw-   1 root     other     1357147 Jan 26 23:41 MB2005.tgz
  349. -rw-rw-rw-   1 root     other       98528 Jan 26 23:41 MBDemo.tgz
  350. -rw-rw-rw-   1 root     other       19745 Jan 27 00:06 MBFiles
  351. -rwxrwxrwx   1 root     other         654 Jan 27 14:14 MBInst
  352. -rw-rw-rw-   1 root     other      295107 Jan 26 23:41 MBLinux.tgz
  353. -rw-rw-rw-   1 root     other         465 Jan 27 00:01 MBMess
  354. -rw-rw-rw-   1 root     other     1154011 Jan 26 23:41 MBqref.tgz
  355. -rw-rw-rw-   1 root     other      724924 Jan 26 23:41 MBrefm.tgz
  356. -rw-rw-rw-   1 root     other      429466 Jan 26 23:42 MBuserm.tgz
  357. -rw-rw-rw-   1 root     other        9817 Jan 28 01:52 README.ENG
  358. -rw-rw-rw-   1 root     other        8309 Jan 28 11:16 README.GER
  359.  
  360.  
  361. Description of these files:
  362.  
  363. MB2005.tgz   : 4GL, Database server, Lower Case Tools and so on.
  364. MBDemo.tgz   : Demo application (stock)
  365. MBLinux.tgz  : Linux configuration files
  366. MBqref.tgz   : Quick Reference Guide (in postscript format)
  367. MBrefm.tgz   : Reference Manual (in postscript format)
  368. MBuserm.tgz  : User's Manual (in postscript format)
  369. MBInst,
  370. MBMess,
  371. MBFiles      : Files for installation
  372. README.ENG,
  373. README.GER   : About MultiBase
  374. INST_GER.txt,
  375. INST_ENG.txt : Installation notes
  376.  
  377.  
  378. II.  INSTALLATION OF MULTIBASE
  379. ------------------------------
  380.  
  381. II.1 Special procedures for Linux installation
  382. ----------------------------------------------
  383.  
  384. Before running MultiBase/Linux you have to do:
  385. - install the Linux Kernel ver. 1.0.9 or newer
  386. - compile the iBCS modul for the actual Linux kernel.
  387.   The kernel must configured before compiling the iBCS modul! 
  388.  
  389.   **********************  NOTE!  ***********************
  390.   *                                                    *
  391.   * The iBCS sources you find in .../ctl/mblinux/iBCS. *  
  392.   * For Linux kernels 1.1.x no patches are necessary.  *
  393.   *                                                    * 
  394.   ******************************************************    
  395.   
  396. MultiBase/Linux was tested including Linux kernel 1.1.52. After this
  397. release the iBCS modul was not running.
  398. In additional you have to map the screen and the keyboard. The necessary
  399. files are saved in .../ctl/mblinux.     
  400.  
  401.   *********************   NOTE!   *****************************
  402.   *                                                           *
  403.   * The program to configure Linux for MultiBase will expect  *
  404.   * the configuration files in the absolute directory         *
  405.   * /usr/ctl/mblinux. If you have chose another directory     *
  406.   * like this, you must change the entries in this script     *
  407.   * (see the next lines!).                                    *
  408.   *                                                           *
  409.   *************************************************************
  410.  
  411.   Configuration script "mblinuxstart" 
  412.   in "/.../ctl/mblinux": 
  413.   
  414.   echo "MultiBase/Linux Anpassung ..." 
  415.   /usr/ctl/mblinux/loadkeys /usr/ctl/mblinux/mblgr.tmap > ...
  416. # |---|                     |---| 
  417. #  depending of directory of installation you must change this!
  418.     
  419.   /usr/ctl/mblinux/mapscrn /usr/ctl/mblinux/mblct.smap
  420. # |---|                    |---| 
  421. #  depending of directory of installation you must change this!
  422.     
  423.   for t in 1 2 3 4 5 6 7 8
  424.   do
  425.       echo -n -e "\\033(K" >/dev/tty$t    
  426.   done
  427.   insmod    /usr/ctl/mblinux/iBCS
  428. #           |---| see above!     
  429.        
  430. After installation MultiBase/Linux enter  
  431.  
  432.               /.../ctl/mblinux/mblinuxstart.
  433.  
  434.  
  435. Normally "..." will be "usr". If "..." is another partial path you set
  436. this in the environments variables.
  437.  
  438. If the system should be configured while booting, you must insert the 
  439. next line 
  440.  
  441.                    /.../ctl/mblinux/mblinuxstart
  442.  
  443. into the file
  444.  
  445.         /etc/rc.d/rc.local    (DLD Distribution)
  446.  
  447. or in the file
  448.  
  449.         /etc/brc        (unifix Distribution).
  450.  
  451.  
  452. II.2 Steps of Installation
  453. --------------------------
  454.  
  455. 1. You need the "gzip" programm from GNU to uncompress the MultiBase Files. 
  456.  
  457. 2. Create a user "ctl" belonging to the group "other". This user must
  458.    exist within the system.
  459.      
  460. 3. Login as user "ctl".
  461.  
  462. 4. Invoke superuser "$su".
  463.  
  464. 5. You must copy the files of installation into the directory "ctl".  
  465.  
  466. 6. Enter "MBInst". 
  467.  
  468. 6. Define the respective environment variables in the ".profile"-file
  469.    of each user to access MultiBase and take care of exporting these
  470.    variables.
  471.  
  472.  
  473.    TRANSDIR="/.../ctl"           ... the directory part where MultiBase
  474.                                     is installed.
  475.    PATH="$TRANSDIR/bin:$PATH"    add TRANSDIR to your path   
  476.    MBLANG="english"              or german or spanish
  477.    MBTERM=con80x25               according to the terminal included in
  478.                                     the $TRANSDIR/etc/termcap of your copy.
  479.                                     
  480.                                     Interactive:
  481.                                     MBTERM=VGA (color), MBTERM=AT386 (mono)
  482.                                     SCO:
  483.                                     MBTERM=VGAansi (color), MBTERM=ansi (mono)
  484.                                     Linux:
  485.                                     MBTERM=console or MBTERM=con80x25
  486.                                         
  487.    NOTE: To assign the right values to these variables consult Appendix D
  488.    of the Reference Manual of MultiBase.
  489.     
  490.  
  491. II.3 Installation of MultiBase demo application
  492. -----------------------------------------------
  493.  
  494. 1. Create a user (mbdemo - for example) belonging to the group "other".
  495.  
  496. 2. Login as user (mbdemo - for example).
  497.  
  498. 3. To have the demo installed as a user type:
  499.  
  500.                    $installdemo
  501.  
  502.  
  503. II.4 Special printer handling
  504. -----------------------------
  505.  
  506.    Linux machines and HP laserprinters:
  507.    
  508.    Define the invironment variable 
  509.    
  510.              DBPRINT="/.../ctl/mblinux/lptrans"
  511.  
  512.  
  513. III. Limitation of the evaluation copy
  514. --------------------------------------
  515.  
  516. 1. The CTL (4GL) Compiler compiled only 1800 statements (4GL-statements)
  517.    for one modul.
  518.  
  519. 2. The maximum of rows per table is 250.
  520.  
  521. IV. Ports of MultiBase/UNIX & MultiBase/UNIX-MOTIF
  522. --------------------------------------------------
  523.  
  524. PC 80386, 80486
  525.  
  526. ALTOS
  527.     386 Series xx
  528.     486 Series xx
  529.     
  530. BULL
  531.     DPX 2000
  532.     DPX 2/ xxx
  533.  
  534. CONTROL DATA 
  535.     4340
  536.     4360
  537.     4380
  538.     4680
  539.  
  540. DATA GENERAL
  541.     AVIION xxxx
  542.         
  543. DEC
  544.     DECSTATION 2100, 3100, 5000/1xx, 5000, 5000-200
  545.     DECSYSTEM  3100, 5100, 5400, 5500, 58xx
  546.  
  547. FUJITSU
  548.     S-1400-1600
  549.     DS-90 xxx
  550.     M-730 Mod. xx
  551.     M-760 Mod. xx
  552.  
  553. HEWLETT-PACKARD
  554.     9000/3xx
  555.     9000/4xx
  556.     9000 SERIES 500
  557.     9000 SERIES 600
  558.     9000/8xx
  559.      
  560. IBM RS/6000 
  561.  
  562. SNI
  563.     RM-xx
  564.     MX-xx
  565.     Targon/31 ../32 ../35 
  566.     Targon 3300, 4400
  567.  
  568. UNISYS
  569.     5000/xxx
  570.     6000/xxx
  571.     7000/xxx
  572.                     
  573.